Diese Funktion berechnet aus dem vorgegebenen Datum die Kalenderwoche und die Anzahl der Tage für die USA und viele anderen Länder, die seit dem Anfang des Jahres vergangen sind.
Baustein Schnittstelle
LGF_GetCalendarWeek_US (FC)
DTL
date
Ret_Val
DInt
calendarDay
DInt
error
Bool
status
Word
Input Parameter
Bezeichner
Datentyp
Beschreibung
date
DTL
Datum zur Berechnung der Kalenderwoche und der Tage seit dem 1. Januar
Output Parameter
Bezeichner
Datentyp
Beschreibung
Ret_Val
DInt
Nummer der Kalenderwoche
calendarDay
DInt
Vergangene Tage seit 1.Januar für das angegebene Datum
error
Bool
FALSE: Kein Fehler / TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status
Word
16#0000-16#7FFF: Status des FB / 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
Status & Error Meldungen
Code / Wert
Bezeichner / Beschreibung
16#0000
STATUS_NO_ERROR Status: kein Fehler aufgetreten
16#8201
ERR_LIM_DATE Datum ausserhalb des gültigen Bereiches, es muss nach dem
<1970-01-01 ; 2262-04-11> liegen
Funktionsbeschreibung
Zählweise für die USA und viele anderen Länder
Kalenderwochen haben 7 Tage, beginnen an einem Sonntag und werden über das Jahr fortlaufend gezählt
Die Kalenderwoche 1 eines Jahres ist diejenige, die den 1. Januar enthält.
Jedes Jahr hat entweder 52 oder 53 Kalenderwochen.
Ein Jahr hat 53 Kalenderwochen, wenn folgende Eigenschaften zutreffen:
Ein Gemeinjahr beginnt an einem Samstag und endet an einem Samstag.
Ein Schaltjahr beginnt entweder an einem Samstag und endet an einem Sonntag oder es beginnt an einem Freitag und endet an einem Samstag.
Die Tage nach dem letzten Dezembersamstag können bereits zur ersten Kalenderwoche des Folgejahres gehören.
Änderungshistorie
Version & Datum
Änderungsbeschreibung
1.0.0
Simatic Systems Support
13.11.2019
First release based on spli from LGF_CalenderWeek (previously LGF_CalenderWeek_ISO)
3.0.0
Simatic Systems Support
23.04.2020
Set version to V3.0.0, harmonize the version of the whole library